update handbook with PostHog Desktop rename by cleo-pleurodon · Pull Request #18780 · PostHog/posthog.com

cleo-pleurodon · 2026-07-22T01:21:11Z

Changes

renamed PostHog Code to PostHog Desktop throughout the handbook
added a positioning page
and cleaned up some stray em dashes in other positioning pages (ew)

Checklist

I've read the docs and/or content style guides.
Words are spelled using American English
Use relative URLs for internal links
I've checked the pages added or changed in the Vercel preview build
If I moved a page, I added a redirect in vercel.json

and cleaned up some stray em dashes

github-actions · 2026-07-22T01:21:48Z

Deploy preview

Status	Details	Updated (UTC)
🟢 Ready	View preview	Jul 22, 2026 10:46PM

github-actions · 2026-07-22T01:22:16Z

Vale prose linter → found 116 errors, 556 warnings, 4 suggestions in your markdown

Full report → · Copy the Job Summary code block into an LLM to batch-fix issues.

Note: Too many findings to show inline. See the Job Summary linked above.

File	Errors	Warnings	Suggestions
`contents/blog/self-driving-product.mdx`	0	6	0
`contents/handbook/brand/tone.md`	1	5	0
`contents/handbook/company/do-more-weird.mdx`	8	2	0
`contents/handbook/engineering/ai/ai-platform.md`	10	22	0
`contents/handbook/engineering/ai/architecture.md`	5	6	0
`contents/handbook/engineering/ai/implementation.md`	0	20	0
`contents/handbook/engineering/ai/products.md`	27	49	0
`contents/handbook/engineering/ai/team-structure.md`	3	18	0
`contents/handbook/engineering/development-process.md`	11	33	0
`contents/handbook/engineering/how-we-review.md`	0	9	0
`contents/handbook/engineering/operations/support-hero.md`	9	11	0
`contents/handbook/growth/sales/how-to-pitch-self-driving.md`	0	3	0
`contents/handbook/growth/sales/product-enablement.md`	6	33	0
`contents/handbook/marketing/positioning/analytics.md`	1	29	0
`contents/handbook/marketing/positioning/data-pipelines.md`	1	41	0
`contents/handbook/marketing/positioning/data-warehouse.md`	0	25	0
`contents/handbook/marketing/positioning/desktop.md`	0	28	0
`contents/handbook/marketing/positioning/endpoints.md`	3	24	0
`contents/handbook/marketing/positioning/experiments.md`	2	30	0
`contents/handbook/marketing/positioning/feature-flags.md`	0	26	0
`contents/handbook/marketing/positioning/index.md`	1	15	0
`contents/handbook/marketing/positioning/llm-analytics.md`	0	15	0
`contents/handbook/marketing/positioning/posthog-ai.md`	0	13	0
`contents/handbook/marketing/positioning/session-replay.md`	0	30	0
`contents/handbook/people/spending-money.md`	24	25	3
`contents/handbook/story.md`	4	38	1

github-actions · 2026-07-22T01:32:14Z

Bundle report

Total JS (gzip)

6.75 MiB (+6.5 KiB / +0.1%)

Largest changed named chunks

Chunk	Gzip	Δ vs master
`component---src-pages-connect-posthog-redirect-tsx.js`	1.8 KiB	new
`component---src-pages-ai-index-tsx.js`	23.5 KiB	+1.7 KiB / +7.7%
`app.js`	2124.0 KiB	+1.2 KiB / +0.1%

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint	Eager size	Budget	Modules
✅ `app`	16.23 MiB (+20.3 KiB / +0.1%)	report-only	1982

Largest modules in the app closure

Module	Size
`./src/data/mcp-tools.json`	897.2 KiB
`css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css`	747.0 KiB
`./src/components/Stickers/Stickers.tsx`	696.4 KiB
`./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js`	481.4 KiB
`./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules`	395.1 KiB
`./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.cjs.js`	364.8 KiB
`./src/hooks/useCustomers.tsx + 54 modules`	355.1 KiB
`./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js`	354.8 KiB
`./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules`	351.4 KiB
`./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js`	281.9 KiB
`./src/components/ProductComparisonTable/index.tsx + 120 modules`	278.6 KiB
`./src/components/SearchUI/index.tsx + 87 modules`	272.1 KiB
`./node_modules/.pnpm/framer-motion@10.18.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/dom/motion.mjs + 109 modules`	253.9 KiB
`./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules`	247.4 KiB
`./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules`	239.9 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

charlescook-ph

I brain-read all the files like a sociopath, looks good!

I think it might be worth pulling out the positioning doc as a separate PR maybe? I feel like that section was generally quite woolly/waffley and not something people would actually use in real life when talking about the product, sorry 🙇

charlescook-ph · 2026-07-22T14:11:39Z

+- Canvases: ask for a dashboard, report, or internal tool and get it built on your real data model *(alpha)*
+- No markup – you pay the token costs, not a subscription stacked on top
+
+## Battle cards


these are pretty good! anything on Notion/Linear?

I don't think anyone would compare PostHog to either at this point?
Maybe linear agents, but that's more self-driving than desktop specifically.

Yeah fair, that's prob vs. the overall PostHog vision vs. desktop specifically (this was the example that came to mind)

charlescook-ph · 2026-07-22T14:13:17Z

+
+*When they push on bill predictability (a fair worry) point at billing limits and per-tool caps. Don't argue that usage-based pricing is painless; argue it's honest.*
+
+### "We already have an established stack. Why consolidate?"


I suspect people will say 'why trust PostHog, you are an analytics company'

cleo-pleurodon · 2026-07-22T14:29:36Z

@charlescook-ph Totally fair (and I agree it's a bit wooly). Figured it was better to have something fast to get reactions to (then then tweak) instead of spending loads of upfront time polishing.
Manual rewrites incoming 🫡

…ging Generated-By: PostHog Code

Generated-By: PostHog Code

cleo-pleurodon added 2 commits July 21, 2026 16:29

update handbook with PostHog Desktop rename

1569270

and cleaned up some stray em dashes

added positioning guide to marketing handbook

c2abf06

cleo-pleurodon requested review from joethreepwood and landon-posthog July 22, 2026 01:21

cleo-pleurodon self-assigned this Jul 22, 2026

github-project-automation Bot added this to PostHog.com planning Jul 22, 2026

github-project-automation Bot moved this to Backlog in PostHog.com planning Jul 22, 2026

cleo-pleurodon moved this from Backlog to Awaiting review in PostHog.com planning Jul 22, 2026

Merge branch 'master' into desktop-positioning-handbook

db44055

cleo-pleurodon requested a review from charlescook-ph July 22, 2026 13:10

charlescook-ph requested changes Jul 22, 2026

View reviewed changes

cleo-pleurodon added 3 commits July 22, 2026 11:43

Update PostHog Desktop positioning with clearer, more authentic messa…

f8ea0ad

…ging Generated-By: PostHog Code

Refine PostHog Desktop positioning with clearer value prop

e861201

Generated-By: PostHog Code

human rewrite

623ae42

cleo-pleurodon requested a review from charlescook-ph July 22, 2026 22:33

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

update handbook with PostHog Desktop rename#18780

update handbook with PostHog Desktop rename#18780
cleo-pleurodon wants to merge 6 commits into
masterfrom
desktop-positioning-handbook

cleo-pleurodon commented Jul 22, 2026

Uh oh!

github-actions Bot commented Jul 22, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 22, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 22, 2026 •

edited

Loading

Uh oh!

charlescook-ph left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

charlescook-ph Jul 22, 2026

Uh oh!

cleo-pleurodon Jul 22, 2026

Uh oh!

charlescook-ph Jul 22, 2026

Uh oh!

Uh oh!

charlescook-ph Jul 22, 2026

Uh oh!

Uh oh!

cleo-pleurodon commented Jul 22, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		When they push on bill predictability (a fair worry) point at billing limits and per-tool caps. Don't argue that usage-based pricing is painless; argue it's honest.

		### "We already have an established stack. Why consolidate?"

Uh oh!

Conversation

cleo-pleurodon commented Jul 22, 2026

Changes

Checklist

Uh oh!

github-actions Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploy preview

Uh oh!

github-actions Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle report

Total JS (gzip)

Eager graph (modules shipped in each entrypoint's initial chunks)

Uh oh!

charlescook-ph left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

charlescook-ph Jul 22, 2026

Choose a reason for hiding this comment

Uh oh!

cleo-pleurodon Jul 22, 2026

Choose a reason for hiding this comment

Uh oh!

charlescook-ph Jul 22, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

charlescook-ph Jul 22, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

cleo-pleurodon commented Jul 22, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions Bot commented Jul 22, 2026 •

edited

Loading

github-actions Bot commented Jul 22, 2026 •

edited

Loading

github-actions Bot commented Jul 22, 2026 •

edited

Loading